home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / MSDOS / (m)aas / ALLMAC.DOC < prev    next >
Text File  |  1987-06-24  |  11KB  |  250 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                          ╔═════════════════════════╗
  25.                          ║         ALLMAC          ║
  26.                          ║                         ║
  27.                          ║     Copywrite 1987      ║
  28.                          ║                         ║
  29.                          ║   By: FRANK SCHWEIGER   ║
  30.                          ║                         ║
  31.                          ║         4/27/87         ║
  32.                          ║                         ║
  33.                          ╚═════════════════════════╝
  34.  
  35.  
  36.  
  37.  
  38.              The BEST READMAC format Picture Processing program.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.     ALLMAC is another READMAC format Picture Processing program which has
  45. many advantages over other READMAC Processing program that are available in
  46. the Public Domain.
  47.  
  48.     1. Automatic support of five different video controller/monitors.
  49.        A. CGA controller with Medium Res. monitor.
  50.        B. EGA controller with Medium Res. monitor.
  51.        C. EGA controller with EGD monitor.
  52.        D. EGA controller with Monochrome monitor.
  53.        E. Monochrome controller with Monochrome monitor (cannot display
  54.           the picture, but can print and EDIT).
  55.        F. Hercules MGA NOT supported at this time (but may be in the future).
  56.  
  57.     2. Support of eight different printers.
  58.        A. EPSON.
  59.        B. Panasonic/Super 5
  60.        C. Apple DMP/NEC 8023
  61.        D. Gemini 10
  62.        E. IBM Graphics Printer (full page, normal aspect ratio)
  63.        F. C.Itoh 8510
  64.        G. Toshiba P321
  65.        H. HP Laserjet
  66.  
  67.     3. Picture EDITING capability.
  68.  
  69.     4. File directory which can be used to select the file to display or
  70.        save.
  71.  
  72.     5. Small "photograph" of picture displayed on main screen.
  73.  
  74.     6. Written in assembly language for efficient operation.
  75.  
  76.  
  77.  
  78.     To start the program simply type ALLMAC. If this is the first time ALLMAC
  79. has been run, it will ask you to define your printer. It will save your
  80. printer definition in a file called ALLMAC.CFG, and subsequent executions will
  81. not have to ask for your printer.
  82.  
  83.     ALLMAC is smart enough to know if you are on an AT or compatible, and will
  84. change your keyboard scan rate while in edit mode so scanning accross the
  85. picture will be faster. When exiting from ALLMAC it will set your keyboard
  86. scan rate to default. If you have previously changed your scan rate, and don't
  87. want ALLMAC to change it, execute ALLMAC with a /D option (ALLMAC /D), and
  88. ALLMAC will not change the scan rate.
  89.  
  90.     ALLMAC's main screen is broken down into four sections.
  91.  
  92.     1. On the left side of the screen is the legend, which describes the keys
  93.        that are available and what they do.
  94.  
  95.     2. On the right side of the screen is a compressed "photograph" of the
  96.        picture that is loaded.
  97.  
  98.     3. On the extreme right side of the screen is the name of the picture
  99.        (obtained from the picture file itself).
  100.  
  101.     4. On the bottom right of the screen is the filename of the picture that
  102.        is loaded.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.     Following is a brief description of the main screen keys and what they do:
  109.  
  110.     1. "D" Displays a directory of all file which match the specified file
  111.         specification. That is ALL this key does. You CANNOT Load or Write
  112.         from this directory. There is limited cursor key movement allowed
  113.         while in the directory to allow you to display all of your files if
  114.         you have more than is displayed on one screen. If you scan up or down
  115.         past the end of the directory, the highlighted file will move to the
  116.         right or left to the first or last file in the directory. Use the ESC
  117.         key to return to the main screen.
  118.  
  119.     2. "E" Will put you in EDIT mode. Use the ESC key to return to the main
  120.        screen. EDIT mode will be described later in this document.
  121.  
  122.     3. "F" Will allow you to change the file specification used to display
  123.        filenames in the directory. Initially it will be set to "*.*". You
  124.        should set it to "*.PIC" or "*.MAC" or "*.??C" or whatever else you
  125.        have named your picture files. Note that the directory displays
  126.        filenames only (no extensions), so if your filespec is "*.??C" and
  127.        you have multiple files with the same filename (but different
  128.        extensions) they may both be displayed as the same filename in the
  129.        directory (AARDVARK.PIC and AARDVARK.MAC both fit the filespec so
  130.        the directory will display two AARDVARK's).
  131.  
  132.  
  133.  
  134.  
  135.     4. "L" Will load a picture. Initially it will ask you to enter the
  136.        filename of the picture or ENTER for the directory. At this time you
  137.        have three options:
  138.           1. Enter the COMPLETE filespec of the picture file (AARDVARK.PIC)
  139.              in which case that will be the file loaded.
  140.           2. Enter just the filename (AARDVARK) in which case the directory
  141.              will be searched for the FIRST match, and that will be the file
  142.              that is loaded. Be careful if you have multiple files with the
  143.              same filename, The lowest alphabetically (including the exten-
  144.              sion) will be the one selected.
  145.           3. Press ENTER to display the directory. With this directory display
  146.              you can move the highlight bar to any file and press ENTER to
  147.              load that file. Again if you have multiple files with the same
  148.              filename, you can only load the first alphabetically (even if
  149.              you place the highlight bar over the second (or third) file.
  150.              This is a program restriction, and ideally you should never have
  151.              multiple files with the same filename and different extensions
  152.              while using ALLMAC. Use option #1 if you do have multiple files
  153.              with the same filename.
  154.  
  155.     5. "P" Will print the picture that is loaded.
  156.  
  157.     6. "S" Will allow you to reconfigure your printer.
  158.  
  159.     7. "V" Will display the picture in its normal size. The full picture is
  160.        576 dots wide by 720 dots high. The full 576 dots in width will be 
  161.        displayed, and you will have to scroll the screen to see all 720 dots
  162.        in length. On a Medium Res monitor (which only display 200 dots high)
  163.        this will cause a very poor aspect ratio, which is a hardware restric-
  164.        tion and cannot be avoided. The best way to see the entire picture is
  165.        to print it. Use the ESC key to return to the main screen.
  166.  
  167.     8. "W" Will save a picture to a disk file. The options and restrictions
  168.        are identical to Load.
  169.  
  170.     9. "HOME", "PG UP", "END" and "PG DN" allow you to change the thresholds
  171.        used in compressing the "photograph". During the 8:1 compression, some
  172.        data is necessarily lost. Using the default thresholds, with some
  173.        pictures, entire lines may dissapear. Use these keys to regain some
  174.        lost details in the "photograph". Note that the compression takes a few
  175.        seconds to perform, so just push these keys once and then wait for the
  176.        "photograph" to change. These changes affect ONLY the "photograph",
  177.        there is no change in the actual picture. There are only five or six
  178.        threshold steps, and assuming you start in the middle, there are only
  179.        two or three steps you can go in any direction, so pushing these keys
  180.        100 times will have no affect after the first two or three pushes.
  181.  
  182.  
  183.  
  184.     EDIT MODE:
  185.  
  186.     ALLMAC's editing capabilities are very simple. The editor was designed
  187. to allow very simple editing jobs. Unless you are a real masochist you would
  188. not want to do any large editing jobs with ALLMAC. The editor works in TEXT
  189. mode, so even monochrome users can edit their pictures.
  190.     First some basics:
  191.  
  192.     1. A full READMAC picture is 576 dots wide by 720 dots high.
  193.     2. Due to the TEXT mode restriction, EDIT mode can only display 72 dots
  194.        wide by 48 dots high at any one time.
  195.     3. In EDIT mode you can only see 1/8 of the width of the picture and
  196.        1/15 of the height of the picture (or 1/120 of the whole picture) at
  197.        any one time.
  198.     4. If the picture has large areas of white (or black), entire EDIT mode
  199.        screens may be white (or black).
  200.     
  201.     To edit a picture, first load it (from the main screen), and then enter
  202. EDIT mode. Use the cursor keys to move the cursor to the area of the picture
  203. you want to edit (if you can find it). Use the space bar to "flip" the desired
  204. bits. Use the ESC key to return to the main screen where you can save the
  205. edited picture to a file.
  206.     As you can see, the ALLMAC editor is not going to rival PCPAINT+ or any
  207. other comercial picture program, but lets see them edit a picture on a mono-
  208. chrome controller and monitor.
  209.  
  210.  
  211.  
  212.  
  213.     And now a word about "donations". If you enjoy this program, and can
  214. afford it, a $5.00 donation would be much appreciated. The source code for
  215. ALLMAC is over 5300 LINES of code. A $5.00 donation is less than 1 penny for
  216. every 10 lines of code. Would you write a program for 10 lines for a penny??
  217. I have no delusions about getting rich with the donations I receive, but any
  218. donations will help keep my wife off my back for spending hundreds of hours
  219. on the computer, ignoring her. If I got 20 donations, I could take her out to
  220. dinner or buy her a new dress, or buy me some more computer equipment
  221. (heh heh). I have also written some games and some utility programs. Anyone
  222. who sends in a donation will receive a diskette of my other programs and be
  223. entered on my mailing list for the future.
  224.  
  225.  
  226.  
  227.  
  228.  
  229.          This  program  is provided "as is" without warranty  of  any
  230.          kind,  either  expressed  or  implied,  including,  but  not
  231.          limited  to  the  implied warranties of  merchantability  or
  232.          fitness for a particular purpose.  The entire risk as to the
  233.          results  and  performance of the program is assumed  by  the
  234.          user.   Should the program prove defective, the user assumes
  235.          the  entire  cost  of all  necessary  servicing,  repair  or
  236.          correction.
  237.  
  238.  
  239.     This program is donated to the PUBLIC DOMAIN, for NON-COMMERCIAL use,
  240.     and may be freely copied for NON-COMMERCIAL use without any restrictions.
  241.     COMMERCIAL use without prior written consent of the author is PROHIBITED.
  242.  
  243.  
  244.     Comments, suggestions or donations (I should be so lucky) may be
  245.     forwarded to:
  246.  
  247.                         Frank Schweiger
  248.                         10083 Heytesbury Ln.
  249.                         Sandy, Ut.   84092
  250.